home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2004 #2 / Amiga Plus CD - 2004 - No. 02.iso / AmiSoft / Dev / misc / WHDLoad_dev.lha / WHDLoad / Src / ReadMeFirst < prev    next >
Encoding:
Text File  |  2003-04-10  |  3.5 KB  |  127 lines
  1.  
  2.  
  3.     Here you will find several source code files and programs which will
  4.     help you in developing your own installs using WHDLoad.
  5.  
  6.  
  7.     gci
  8.     ---
  9.  
  10.     The Graphical Coder Interface is a MUI program to display the contents
  11.     of a dumpfile created by WHDLoad. Its not completely finished but the
  12.     souurce is included so you can enhance it yourself (please share
  13.     them!).
  14.  
  15.  
  16.     imager-examples
  17.     ---------------
  18.  
  19.     These are sources for imager using RawDIC or Patcher.
  20.  
  21.  
  22.     macros
  23.     ------
  24.  
  25.     some macros which are required for some sources
  26.  
  27.  
  28.     memory-speed
  29.     ------------
  30.  
  31.     These are results from the Speed.Slave for various different hardware
  32.     configurations. It shows how fast memory accesses are on differnt
  33.     platforms. It also illustrates the limited cachebility on various
  34.     accelerator boards or the access speed for Custom and Cia chips.
  35.  
  36.  
  37.     programs
  38.     --------
  39.  
  40.     some small tools, maybe useful for you
  41.  
  42.     WCmp:
  43.     simple compare utility, has wide output (16 bytes per line), shows
  44.     only differences, doesn't load whole file but works buffered,
  45.     interruptable with ^C
  46.  
  47.     WDate:
  48.     I use this to insert the date and time of assembling into the
  49.     created executable (see example-slaves)
  50.  
  51.     WVer:
  52.     I use this to increase the revision number each time the source
  53.     will be assembled (similar usage as WDate)
  54.  
  55.  
  56.     resource
  57.     --------
  58.  
  59.     Support files to use with ReSource package by The Puzzle Factory.
  60.     It contains symbol files and macros to decode WHDLoad Slaves.
  61.  
  62.  
  63.     slave-examples
  64.     --------------
  65.  
  66.     The Slave examples are the recommend reading if you want self write
  67.     Slaves.
  68.  
  69.     winditup.asm:
  70.     this is a very simple Slave to give you an overview how a Slave is
  71.     working, the Slave loads from a disk image and uses the keyboard
  72.     routine provided in the sources directory
  73.  
  74.     oscar.asm:
  75.     this is a simple example for using usual files, it also contains a
  76.     simple exec.AllocMem() emulation which works fine as long as no
  77.     FreeMem() is required
  78.  
  79.     interphase.asm:
  80.     shows the usage of "savegame.s"
  81.  
  82.  
  83.     sources
  84.     -------
  85.  
  86.     these sources are code fragments containing one or more sub routines,
  87.     they should be used by including them at the bottom of the Slave
  88.     source and calling from the slave source
  89.  
  90.     blitfix_#?.s:
  91.     these routines will patch instructions which are writing to the
  92.     blitsize custom register, the patched instruction will be replaced by
  93.     a routine doing the same but previously waiting for the blitter to
  94.     finish,    very useful to fix programs which will not correctly wait
  95.     for blitter finish
  96.  
  97.     keyboard.s:
  98.     this file contains a complete keyboard initialisation and the required
  99.     interrupt handler, it will be useful for programs without a own
  100.     keyboard handling (most demos) or for programs with broken handling
  101.     (in this case you have to disable the original)
  102.  
  103.     savegames.s:
  104.     this routine contains a system for multiple savegames, there is
  105.     special code which creates a interface to select a save position and
  106.     to enter a description for each    savegame
  107.  
  108.     dbffix.s:
  109.     contains a routine to fix empty dbf loops, that means all instructions
  110.     like "dbf dn,*" will be patched by a wait routine based on vertical
  111.     raster beam, a well known example for empty dbf loops is the playback
  112.     routine of the old soundtracker used in many demos and games
  113.  
  114.  
  115.     PLEASE NOTE
  116.     -----------
  117.  
  118.     My Assembler is able to optimize the addressing mode (and much more):
  119.         (xxxxxxxx).L    -->    (d16,PC)
  120.     if possible.
  121.  
  122.     So I never do this myself !
  123.     Remember Slaves must be 100% PC-relativ !
  124.     So if your Assembler isn't able to do this and you want to use these
  125.     sources you have to add the "(pc)" by yourself. (or just get a better
  126.     assembler!)
  127.